home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-01 / proto212.zip / LISMOI < prev    next >
Text File  |  1992-01-24  |  9KB  |  227 lines
  1.     Cette version de l'extracteur de prototypes est un "shareware".
  2.     Ce n'est pas une version complète. Solucorp fournis ce programme
  3.     uniquement pour évaluation. L'usager a 30 jours pour l'évaluer.
  4.     Lorsque l'usager s'enregistre en payant 25$ US ou 30$ canadien,
  5.     il reçoit une version complète de l'extracteur ainsi que plusieurs
  6.     utilitaires.
  7.  
  8.     L'usager recevra une version DOS, une version UNIX,XENIX
  9.     (pour ordinateurs 386/486) and une version SUN SPARC.
  10.     L'usager recevra aussi un numéro d'enregistrement lui permettant
  11.     de commander n'importe quel révision future de ce produit pour
  12.     la modique somme de 10$ (10$ pour chaque révision).
  13.  
  14.     Ce qui suit est une présentation des utilitaires. Le fichier exemple.zip
  15.     fournit une description plus complète de l'utilisation de ces programmes.
  16.     Solucorp se réserve le droit de modifier la composition de cet ensemble
  17.     de programme sans préavis.
  18.  
  19.  
  20.     -Dircmd: Un "file find" amélioré.
  21.     -Make: Un make amélioré.
  22.     -Makedep: Un constructeur de dépendances pour makefile.
  23.     -Naloc: Un localisateur de déclarations de fonctions.
  24.     -Naperm: Un formatteur d'indexs.
  25.     -Nadoc: Un formatteur de documentation.
  26.     -Nulfct: Elimine certains appels de fonctions dans un source.
  27.  
  28. Dircmd: Un "file find" amélioré.
  29.  
  30.     Dircmd permet de localiser des fichiers et répertoires à partir
  31.     de critères de sélection complexes (date,multiples wildcards,
  32.     exclusion, comparaison de répertoires, etc...). De plus,
  33.     il permet d'assembler des commandes à partir du nom des fichiers
  34.     trouvés.
  35.  
  36.     La commande suivante efface tous les fichiers .obj associés aux
  37.     fichiers .c sur un disque.
  38.  
  39.     dircmd -s -e *.c del %p%\%b.obj
  40.  
  41.     Cette commande détruit chaque fichier apparaissant et dans le
  42.     répertoire "travail" et le répertoire "archive" et qui ont la même
  43.     date de révision et la même dimension. La destruction se fait
  44.     dans le répertoire "travail".
  45.  
  46.     dircmd -c+=\archive -e \travail\*.* del %s
  47.  
  48.     Dircmd est essentiel pour la gestion de larges disques dures et
  49.     de réseaux.
  50.  
  51. Make: Un make amélioré.
  52.  
  53.     Le make de Solucorp introduit plusieurs extensions. Il permet
  54.     la construction de makefile portable entre DOS et UNIX. Voici
  55.     une liste d'extensions par rapport aux make standard.
  56.     Voir le fichier makefile dans exemple.zip.
  57.  
  58.    -Elimine la limitation de DOS pour les lignes de commande.
  59.  
  60.     DOS limite une ligne de commande à 126 caractères. Make résout ce
  61.     problème de façon quasi invisible.
  62.  
  63.    -Elimine la limite de 640k de DOS.
  64.  
  65.     Make peut soit s'éliminer temporairement de la mémoire ou
  66.     déclencher un "window DesqView" séparé, libérant pratiquement
  67.     toute la mémoire disponible.
  68.  
  69.    -Traitement conditionnel.
  70.  
  71.     Make supporte un ensemble complet de directive fonctionnant comme
  72.     le préprocesseur du compilateur C.
  73.  
  74.    -Projet distribué.
  75.  
  76.     Make peut opérer de façon transparente avec des sources, des
  77.     fichiers objets et des librairies disposés dans des répertoires
  78.     différents. La disposition exacte est indépendant des règles inscrite
  79.     dans les makefile. C'est ce qui permet d'obtenir des makefile
  80.     "transportables".
  81.  
  82.    -Syntaxe de définition de macro.
  83.  
  84.     Make supporte la définition de macro à partir de wildcards.
  85.     Il supporte l'exclusion.
  86.  
  87.    -Révision dynamique du contenu d'une macro.
  88.  
  89.     Un fois une macro définie, on peut l'utiliser comme telle, ou
  90.     avec modifications.
  91.  
  92.    -Gestion automatique des dépendances entre un sources et les
  93.     fichiers d'inclusion qu'il référence. Voir l'utilitaire makedep.
  94.  
  95.    -Option touch sélectif.
  96.  
  97.     Un "touch" peut être appliqué sur toutes les cibles qui ne sont
  98.     plus à date, seulement si elles sont rendues désuettes par une
  99.     dépendance spécifique.
  100.  
  101.    -Option de déverminage permettant d'inspecter l'arbre de décision
  102.     du make.
  103.  
  104. Makedep: Un constructeur de dépendances pour makefile.
  105.  
  106.     Makedep lit une série de fichier source et produit un fichier
  107.     "parallèle" qui sera utilisé par make. Ce fichier indique la
  108.     dépendances entre un fichier sources et des fichiers d'inclusion.
  109.     Vous n'avez plus à réviser le fichier makefile à chaque fois
  110.     qu'un fichier d'inclusion est ajouté à un source.
  111.  
  112.     Voir le fichier makefile.dep dans exemple.zip.
  113.  
  114. Naloc: Un localisateur de déclarations de fonctions.
  115.  
  116.     Naloc localise le source contenant la déclaration d'une fonction
  117.     n'importe où dans un projet à plusieurs sources, et plusieurs
  118.     répertoires. Se rattache facilement à un éditeur programmable.
  119.  
  120. Naperm: Un formatteur d'index.
  121.  
  122.     Ce programme produit trois fichier: Un sommaire, un index permutté
  123.     et un historique des révisions d'une librairie. Voir le fichier
  124.     document.exm dans exemple.zip.
  125.  
  126. Nadoc: Un formatteur de documentation.
  127.  
  128.     Nadoc produit un document complet sur un système (librairie)
  129.     à partir d'un squelette. Vous n'inscrivez que les sections et
  130.     sous-sections accompagnées d'une courte description, et 
  131.     identifiez les fonctions qui font partie de ces sections.
  132.     Nadoc produit automatiquement un document à partir de la documentation
  133.     extraite des sources. Il crée la table des matières. Il produit
  134.     un rapport mentionnant les fonctions qui n'existent plus et
  135.     les fonctions qui n'ont pas été classifiées.
  136.  
  137.     Un outils essentiel pour produire du code réutilisable, réutilisé !
  138.     Voir document.exm dans exemple.zip.
  139.  
  140. Nulfct: Elimine certains appels de fonctions dans un source.
  141.  
  142.     Nulfct élimine tous les appels fait à une fonction dans une
  143.     série de source. Il produit un fichier temporaire qui sera
  144.     compilé, laissant l'original inchangé. Il peut faire le traitement
  145.     en parallèle pour plusieurs fonctions. Les fonctions éliminés de
  146.     cette façon sont généralement utilisé pour le déverminage.
  147.  
  148.  
  149. --------------------------------------------------------------------
  150.  
  151.     Nouvelles options et corrections de proto. Extraits du manuel
  152.     protof.man.
  153.  
  154. --------------------------------------------------------------------
  155.  
  156. 1       Introduction et avertissements 
  157.  
  158.   L'extracteur de prototypes automatise et agrémente une 
  159.   partie du travail d'un programmeur en langage ANSI C et C++ 
  160.   2.0. Il supporte aussi la syntaxe de déclaration de 
  161.   fonctions K&R. 
  162.  
  163.   Une version existe pour MSDOS (PCDOS) version 3 et plus, 
  164.   pour SCO XENIX version 2.3 (UNIX système V.3.2) et pour SUN 
  165.   SPARC (Sunos). 
  166.  
  167.   Ce manuel s'applique intégralement dans les trois 
  168.   environnements. Toutefois, le séparateur / a été choisi pour 
  169.   la spécification de fichiers dans le manuel. La version 
  170.   MSDOS du logiciel reconnaît le séparateur \ et non pas /. 
  171.  
  172. 3.3     Mot-clés ajoutés pour automatiser l'opération de
  173.         l'extracteur 
  174.  
  175.   Le langage C++ ne permet pas d'extraire les prototypes d'une 
  176.   façon complètement automatique. Pour sa part le langage C 
  177.   possède un concept rudimentaire de controle de l'accès. 
  178.  
  179.   Sept mot-clés sont interprétés par l'extracteur pour 
  180.   complètement controler la génération des prototypes à partir 
  181.   du source. 
  182.  
  183.       export      C et C++
  184.       _export     C et C++
  185.       PRIVATE     C++
  186.       PUBLIC      C++
  187.       PROTECTED   C++
  188.       STATIC      C++
  189.       VIRTUAL     C++
  190.  
  191. 3.4.3   -b : Mise à jour d'un fichier C++ à partir d'un
  192.         fichier .pm 
  193.  
  194.   Normalement, proto regroupe tous les prototypes des 
  195.   fonctions membres d'une classe C++ dans un seul fichier 
  196.   (voir -m0+,-m1+ et -c+). Ce fichier porte généralement 
  197.   l'extension ".pm". A partir de ce fichier, les prototypes 
  198.   des fonctions membres sont distribués dans les fichiers qui 
  199.   contiennent les déclarations des classes. L'option -b active 
  200.   cette distribution. 
  201.  
  202.   La syntaxe de l'option est: 
  203.  
  204.       -bfichier_à_réviser+fichier_pm=fichier_résultat
  205.       -bfichier_à_réviser+fichier_pm
  206.       -bfichier_à_réviser
  207.       -b
  208.  
  209.   Si fichier_résultat n'est pas spécifié, fichier_à_réviser 
  210.   sera pris comme source et destination. Si fichier_pm n'est 
  211.   pas spécifié, X.pm sera choisi (X est le nom du répertoire 
  212.   courant). L'option -b sans arguments sera équivalente à 
  213.   -bX.hpp+X.pm où -bX.h+X.pm où X est le nom du répertoire 
  214.   courant. X.h sera utilisé si X.hpp n'existe pas. 
  215.  
  216.   L'option -b peut être utilisé plusieurs fois (pour réviser 
  217.   plusieurs fichier d'inclusion) sur la ligne de commande. Son 
  218.   action ne sera déclenchée qu'après l'extraction du dernier 
  219.   prototype. 
  220.  
  221. 3.4.15  -o : Nom alternatif pour l'option -m 
  222.  
  223.   L'option -m compose le nom des fichiers resultats à partir 
  224.   du nom du répertoire courant. L'option -o permet de 
  225.   spécifier un autre nom 
  226.  
  227.